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Library Overview 


Overview 


libpad is the controller library for the PlayStation2. The current version is compatible with the following 
PlayStation controllers: 


(1) Digital controller (ID = 4) 
(2) Dual Shock (ID = 7) 

_ (3) NeGcon (ID = 2) 

` (4) Analog joystick (ID = 5) 


"In the future, the system will be compatible with almost all PlayStation controllers. Additional compatible 
controllers will be added over time. 


The main functions of the library are as follows: 


(1) Get button data KN 


(2) Change controller mode 


(3) Control actuator (vibrate) 


Configuration 


libpad consists of an IOP module and an EE library. The IOP module is loaded and initialized by the IOP 
-Remie during boot-up. Nothing needs to be.set by the application. 


The EE library is linked to an application program before use. The link file is liopad.a, and the include file is 
i libpad.h. 


IOP Module 


The module for the controller library is padman.irx. By specifying this module in jopeönt, the IOP kernel will 
— Baoaded during boot-up. i 


, 
t 


EE Library 
To use the library, libpad.a and libpad.h should be copied to the appropriate directories. 


"In the standard configuration, the library file should be copied to /usr/local/sce/ee/lib and the include file i 
should be copied to /usr/local/sce/ee/include. : , 


When using the library, it is necessary to specify the library in each Makefile. This can be doneby +&%' “+ 
+ Sppending -Ipad to the link options... a 
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Controller Library 


Notes 


(1) The operation of libpad has been verified by means of the T-10000 development tool. It will not run on 
other development systems (e.g., EB-2000). 


(2) libpad cannot coexist with the pad/pads drivers used in sceOpen( that is provided by the fileio.irx 
module, so the pad/pads drivers should not be used. 


However, if it is necessary to use these drivers, then the padman.irx IOP module should be deleted (i.e., it 
should not be loaded during boot-up). The files loaded during boot-up are specified in 
/usr/local/sce/iop/modules/iopconf. Edit this file and comment out the appropriate line(s) so that 
padman.irx is not loaded. 


Library Operation 


The controller library runs mainly on the IOP. Communication with the controller is performed automatically 
by means of padman.irx on the IOP by means of the VBlank interrupt, once per frame. The communication 
results are sent sequentially to the EE's RDRAM, using DMA. 


Regarding the dynamics of communication with the controller, SCEI plans to extend the functionality so 
that, in the future, it will be freely settable from the application. The minimum interval for communication 
with the same controller is about one frame. 


Restrictions of the Current Version 


Although the multiplayer adapter was taken into consideration in the design, it is not supported in the 
current version. 


Description of EE Library Functions 


The following functions are provided in the EE library libpad: 


Name Function 

Padinit Initializes libpad 

PadPortOpen Begins communication 

PadRead Gets button data 

PadGetState . Gets controller connection state 

PadinfoAct Gets actuator information . 

PadinfoComb Gets information on the combination of simultaneously 
operable actuators 

PadinfoMode Gets information regarding the controller mode 

PadSetMainMode Change controller mode / lock changeover switch 

PadSetActDirect Sends actuator parameters to the controller 

PadSetActAlign Send details of actuator parameters to the controller 
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Functions 


PadGetState 


Get controller connection state 


s ý it a, 

int PadGetState( 

int port, Controller port number 
int s/ot) (Currently fixed at 0.) 


Return Value 
Controller connection state (see table below) 
Gets the connection state of the controller on the opened port. 


When a port is opened, the IOP's padman.irx module independently monitors the connection and gets 
information for the connected controller. 


When the controller state changes, it is necessary to communicate with the controller several times to allow 
for latencies until the operation completes. During this interval, the button state cannot be obtained, and 
application reguests cannot be received. 


An application should use the PadGetState() function to determine the processing state of padman.irx. 
The valid return values are as follows: 


Return Value Meaning 

PadStateDiscon Controller is not connected 
PadStateFindPad Controller found (processing continuing) 
PadStateFindCTP1 Detected the CTP 1.0 controller 
PadStateExecCmd Communicating with controller 
PadStateStable Detected the CTP 2.0 controller 
PadStateError Communication error detected 


Application requests can be processed and button state can be obtained when the module is in the 
PadStateFindCTP1 or PadStateStable states. 
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PadinfoAct 
Get actuator information 
Syntax ; 
int PadinfoAct( 
int port, Controller port number 
int slot, (Currently fixed at 0.) 
int actno, Actuator number 
0 to total number of actuators-1 or 
-1 to obtain the total number of actuators 
int term) (see table below, ignored if actno = -1) 
Return Value’. De 
The relationship between the term argument and the return value is as follows: 
term Return value 
1 Function no. 
1: continuous rotation-type vibration 
2 Subfunction no. 
1: low-speed rotation, 2: high-speed 
rotation 
3 Parameter data length 


O: 1 bit (on/off only), 
1 or more: no. of bytes 
4 Consumed current capacity 


In addition, if actno = -1, the return value contains the total number of actuators. In this case, the term 
argument is ignored. 


Description = suede gare a 
Gets detailed information regarding actuators on the controller. When actno = -1, it also obtains the total 
number of actuators. This function is valid only when PadGetState() = PadStateStable. 
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PadinfoComb 

Get information on the combination of simultaneously operable actuators 
Syntax 

int PadinfoComb( 

int port, Controller port number 

int slot, (Currently fixed at 0.) 

int fistno, List number of combination list 


O to total no. of combination lists-1 or 

-1 to obtain the total number of combination lists 
int offs) Offset in combination list 

0 to total no. of actuators in list-1 or 

-1 to obtain the total number of actuators in the list 


Return Value 
listno offs Return value 
-1 X Total no. of combination lists 
O to (total- 1) -1 Total number of actuators in list 
O to (total-1) (O to total-1) Actuator no. stored at offset offs in the 
listno list 


Gets the combinations of actuators that are operable simultaneously. The number is limited by a number 
of factors such as the physical location of the actuators. 
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PadlnfoMode 


Get information regarding the controller mode 


int PadinfoMode( 


int port, Controller port number 

int slot, (Currently fixed at 0.) 

int term, Item to be checked 

int offs) Offset in controller mode ID table that contains the 


controller mode ID to be checked 


The return value for the various values of term is as follows: 


term Return value 

1 Currently operating controller mode ID 
Valid no. of digits: 4 bits (same as the value of the button information's 
terminal type) 

2 Mode ID of the currently operating controller for controllers with a 


vibration function 
Valid no. of digits: 16 bits (0 for SCPH-1150 or vibration function 
incompatibility) 


3 Offset in table which contains the currently operating controller mode 
ID (0 for SCPH-1150 or vibration function incompatibility) 
4 Controller mode ID stored at offset specified by offs, in the controller 


mode ID table (0 for SCPH-1150 or vibration function incompatibility) 


Allows the currently operating controller mode ID to be checked, controllers that are compatible or 
incompatible with the vibration function to be identified, and determines the controller mode ID of 
controllers with the vibration function. 


(The SCPH-1150 controller does not have a vibration function and is handled as an exception.) 
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Initialize liopad 


int Padlnit( 

int mode) 

Return Value. _ 

1: Terminated normally 

Other than 1: Initialization failure 


Description +... 


Initializes the controller library libpad. 


(Currently fixed at 0.) 
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PadPortOpen 

Begin communication 

int PadPortOpen ( 

int port, Controller port number (O or 1) 

int slot, (Currently fixed at 0.) 

u long128* data) Work buffer (The required size is defined by the constant 
PadDmaBufferMax.) 

Return Value: 


1: Reguest received. 


Other than 1: Reguest not received. 


Opens the specified controller port. 


When the controller port is opened, padman.irx monitors the controller connection. After the connection is 
made, the controller information is automatically obtained. 


Button information can also be obtained. Once the controller port is open, there is some latency until 
button information becomes available. Monitor PadGetState() to determine whether or not button 
information is available. 
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PadRead 

Get button information 

int PadRead( 

int port, Controller port number (O or 1) 

int slot, (Currently fixed at 0.) 

unsigned char* data) Pointer to buffer in which button information is stored. 
Buffer must be 32 bytes. 


0: Failed to get information. 
Other than 0: Length of obtained data (currently fixed at 32) 


Description | 
Gets the latest button information sent to the EE. The button information is sent only for the opened port. 
The contents of the buffer are shown below: 


Button State Bit Assignments (Offset 2) 


+-----—-----—----———------- +--+-—-4--4——+——4-——+4-——4——11 
|Bit offset 7 6 5 4 3 2 1 0 | 
|Digital controller < V > * sf SEL | 
| DualShock < V > ^ ST R3 L3 SEL| 
| analog joystick < V > ^ ST SEL | 
| NeGcon < V > ^ ST | 
+------------------------ +--+--+--+--+--+--+--+---4+ 
Note: 
< = left-arrow key 
> = right-arrow key 
V = down-arrow key 


up-arrow key 


Button State Bit Assignments (Offset 3) 


pace en nn nn noo +--+--+--+--+--+--+--+--+ 
|Bit offset 7 65 4 3 2 1 0 | 
| Digital controller Bx X O Tr R1 L1 R2 12] 
| DualShock Bx X O Tr R1 L1 R2 12] 
|Analog joystick Bx X O Tr R1 L1 R2 12] 
| NeGcon A B R | 
panne en en ee ew een nee +--+--+--+--+--+--+--+--+ 
Note: 


Bx = Box key 

X = Cross key 

O = Circle key 

Tr = Triangle key 
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Digital Controller Data Array 
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Offset(bytes) Contents 
0 Successful communication: 0, otherwise: Oxff 
1 High-order 4 bits: Ox4 
Low-order 4 bits: Data length/2 
2,3 Digital button state (1: released, 0: pushed) 
DualShock Data Array 
Offset(bytes) Contents 
0 Successful communication: 0, otherwise: Oxff 
1 High-order 4 bits: Ox7 
Low-order 4 bits: Data length/2 
2,3 Digital button state (1: released, 0: pushed) 
4 Analog stick right (X direction) 
5 Analog stick right (Y direction) 
6 Analog stick left (X direction) 
7 Analog stick left (Y direction) 
Analog Joystick Data Array 
Offset(bytes) Contents 
0 Successful communication: 0, otherwise: Oxff 
1 High-order 4 bits: Ox5 
Low-order 4 bits: Data length/2 
2,3 Digital button state (1: released, 0: pushed) 
4 Analog stick right (X direction) 
5 Analog stick right (Y direction) 
6 Analog stick left (X direction) 
7 Analog stick left (Y direction) 
NeGcon Data Array 
Offset (bytes) Contents 
0 Successful communication: 0, otherwise: Oxff 
1 High-order 4 bits: Ox2 
Low-order 4 bits: Data length/2 
2,3 Digital button state (1: released, 0: pushed) 
4 Rotary part's analog data 
5 | button analog data 
6 Il button analog data 
7 L button analog data 
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PadSetActAlign 

Send details of actuator parameters to the controller 

Syntax 

int PadSetActAlign( 

int port, Controller port number 

int slot, (Currently fixed at 0.) 

unsigned char* data) Sent details of actuator parameters (6 bytes) 


1: Request received. 


Other than 1: Request not received. 


Notifies the controller of the locations where the actuator parameters are stored in the send buffer, by 
writing the actuator numbers in a 6-byte array. 


In the following example, send buffer offset O is used as actuator no. O, offset 1 is used as actuator no. 1, 
and other data are not used. (The actuator numbers are stored in valid locations, and unused locations are 
set to Oxff.) 


Offset: 0 1 2 3 4 5 
Data contents: OxOO 0x01 OxFF OxFF OxFF OxFF 
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PadSetActDirect 


Send actuator parameters to the controller 


int PadSetActDirect ( 
int port, 
int s/ot, 
unsigned char* data) 


Return Value 
1: Successful transmission 


Other than 1: Failure 


ih vi hei b 
‘BSsScrivniuc 


Controller port number 

(Currently fixed at 0.) 

Starting address of transmit data 

6 bytes of transmit data should be provided 


Sends the transmit data to the IOP for operating an actuator. The transmitted data is sent to the controller 


at the next VBlank interrupt. 
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PadSetMainMode 
Change controller mode / lock changeover switch 
Syntax 
int PadSetMainMode( 
int port, Controller port number 
int slot, (Currently fixed at 0.) 
int offs, Offset in controller mode ID table containing the switched 
controller mode 
int lock ) O, 2: Maintain current locked or unlocked state of 
changeover switch 
1: Unlock changeover switch 
3: Lock changeover switch 
Return Value 


1: Successfully processed 
Other than 1: Request not received. 
Description 


Switches controller modes, and switches between the locked and unlocked states of the mode switch 
button on the controller's main unit. 


When this function is executed, other requests cannot be received immediately, and controller button 
information will not be available. The completion of processing should be checked using PadGetState(). 


In addition, when the controller mode is switched, previously set actuator settings become invalid. 
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